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Introduction to LKDOE 
The Larken disk system for the Timex 2068 is fully Spectrum 
compatible and also can be used with Aros or Lros cartridge roms 

It supports all token keywords - CAT, ERASE,LOAD,SAVE,MERGE, 
OPEN#,CLOSE# and also GOTO and PRINT that were intended to be 
used with a external mass storage device. FORMAT and MOVE are 
supplied as programs that run in ram. 

The way these commands are implimented by the Larken system is 
to preceed them with a Rand usr 100: 

eg: RAND USR 100: CAT ””, 

For easier typing and a shorter command the PRINT #4: command 
can be used instead of Rand Usr 100:. To use PRINT #4: you must 
first Open Channel 4 to the diskdrive with - 

RAND USR 100: OPEN f4, "dd” 
You can now preceed all LKdos and Ex-basic commands with 


PRINT #4: eg: PRINT #4: LOAD "filename.ex” 
If the Print #4: command is used before it has been 
initialised, error O - Invalid Stream will result. 


LKDOS File Names 
The only other difference between a Lkdos command and a 
standard cassette command, is the file name. 

Lkdos uses a file name that contains a program name up to 6 
characters followed by a two character ‘’extension’. A period 
separates the program name from the extension. The first letter 
of the extension tells the dos what type of file it is . It must 
be an A,B or C 

"A"' for Array "B’ for Basic ’C’ for Code 
The second letter of the extension can be any character exept, 
if you are saving a string array, it must be a '$". 

The extension must be two characters long. 

The only character that can’t be used in a file name is a 
This is used as a 'wildcard’ character for use in CAT searches. 

Some examples of file names: 


IN»? 


"Progrm.B1” A Basic program 
"zeus.Cx” A code file 
"Names. A$” A String Array 
”Numbrs. A1” A Numeric Array 


SAVE COMMANDS 

Before you can save your programs and data to the disk, your 
disk must be formatted. (See section on setup and formatting) 
Any formula or expression in a command can be used. 

eg: PRINT #4: SAVE a$ (TO 6)+”.CT” CODE Start,End-Start 
All variations of cassette commands are supported. 


PRINT #4: SAVE ”Prog.B1” - Basic program 
> SAVE ”Prög. BY" LINE 100 - Basic Auto run 
: SAVE ”Prog.C1” CODE start,length - Bytes save 
: SAVE. "Prog.C1"-SCREEN$ ~ Screen save 
: SAVE ”Prog.aAl” DATA () - Numeric Array 
: SAVE "Prog. A$” DATA $() - String Array 


Before saving make sure that the write protect notch on the 
disk is not covered by a protect sticker and that the disk is 
in the drive properly with the door closed. 


LOAD 

Similarly all cassette load commands are supported. 

Å special feature in the load command will allow your basic prog 
to continue even when a 'File Not Found’ error has occured. 

If you POKE 23728,100 before doing a Load command, your program 
will not stop with error T if the dos can't find the file. 
Instead, the dos will print "NO FILE” on the screen in the 
current print position and return to your basic program. It will 
also put 101, in 23728 to indicate it didn’t find the file. 

This feature was added for programs such as wordprocessors etc. 
that load and save text or work files from within them. 

The ON-ERROR command does not recognise Lkdos errors. 


MERGE 

The Merge command differs from the cassette Merge in a few 
ways. Programs aren’t automaticaly stopped when merged like the 
cassette does. This allows ‘basic overlays’ which means that a 
Basic program can be far larger than what can he loaded into the 
computer at once. You can have parts of a program merged into 
your main controlling program when necessary. 

Two rules determine from what line # the program will continue 
at, after a merge command. 

- Jf a running Basic program merges an other program into 
memory, the first basic program will continue and have control 
over the merged program. The merged program’s autorun line# will 
be ignored. 

- If a program is merged from a immediate command (not running) 
, the merged program will start from its autorun line #. 

Tf it is not an auto run program it will not run. 

Due to the fact that programs are stored on the disk in blocks, 
the maximum size of any line in a program to be merged is 1200 
bytes. Merging from disk is a complex process and there will 
be noticable difference in the speed of a merge compared to a 
load. 

The merge command doesn’t merge program variables only the 
program lines. This makes you basic overlay programs easier to 
program. 


CAT (Catalog) 

The Cat command displays the disk name, all the files on the 
disk along with the size of each file in blocks, and the type of 
disk, number of files and free blocks. 

The syntax for the Cat in the 2068 is Cat "", . The quotes 
can be closed quotes or they can contain part of a string that 
you would like searched for, in the catalog. 

g: Print #4: Cat ”.Bz”, would print all the files 
that had ”.B2” in them. 

The ’T’ is used as a wild card character and can be substituted 
forany character. 

eg: If a disk had files called prog!.Bx , Progl.B* , Prog2.BB 
, Prog2.Bx on it. 


And the command was - Print #4: Cat "Progt.B*” 
The Cat command would find - Prog1.B* 
Prog2.B* 


The Spectrum does not allow the search function since the 
syntax is only - Print #4: CAT 
To send a copy of the catalog to the printer you can Open 
channel 2 to the printer then do the Cat command. 
Open #2,”p” for small printer 
Print #4: Open #2,"lp” for large printer 
(note- use Lkdos Close command to close #2 . See Ex-Basic 
commands for use of OPEN command ) 


ERASE 

The Erase command deletes the file on the disk. The blocks used 
by the file will be made reavailable to the free blocks. 

The erase syntax requires a comma after the file name. 


GOTO 

The Goto command is used to select which diskdrive is to be 
used for the next disk commands. The Larken disk interface will 
support up to 4 drives, Numbered 0 to 3. Goto 4 will select the 
ramdisk. 

The selected drive will stay selected until an other Goto 
command or the system is turned off. 

Drive 0 is selected during power up. Pressing 'J” on powerup 
will select ramdisk. 


PRINT 

The Print #4: Print ”File” displays the file to screen or 
printer directly from disk without altering your program memory. 
It can be used to search a disk for a program or even to examine 
a NMI save to see the contents of memory. The listing of basic 
programs will not print line numbers, but word processor files 
and text are fairily accurate. This command was inspired by the 
CPM ’type’ command. 


LPRINT 

The Print #4: LPRINT "file” command is basicly the same as the 
PRINT command exept the file is send to the Printer instead of 
the screen. If the file contains printer bee codes (escape 
codes) then you should Print #4:POKE 16098,3 and also Poke 16093 


,32 to disable any filtering by the printer pda and lprint 
command. 


NEW 

Entering the command Print#4:NEW will cause the dos to do a 
warm Start. This can be used to reload an Autostart program from 
the current drive. If an autostart is not on the drive then it 
will do a cold start. A warm start doesnt change any of the 
settings in the cartridge or any selected banks. 


MOVE (Remame) 

The Print #4: MOVE "oldname”, "”newname"” command will rename a 
file on disk. This is useful for giving NMI saves a more 
meaninful name or changing the name of any file. It does not 
check for an extension (.B or .C etc) so use it wisely. You can 
rename a NMI save with a °.B’ extension so it can be loaded with 


out using the CODE token. 


SEQUENTIAL FILES 

A sequential file is a file that is read from or written to, 
one character at a time. Just as the way that you print to the 
screen or the printer by sending one character at a time, you 
can now send characters or data to a file on disk the same way. 
The 2068 uses channels 0 to 15 to send and receive data to the 
screen or printer or from the keyboard. Channels 2 to 15 can be 
also used for LKdos sequential files. 


(Note - The 2068 uses the command PRINT # to send data to a 
channel . Eg: Print #2 ; "the brown fox” 
Do not confuse this with the ’Print #4:’ that is used to preceed 
LKdos commands. In the following examples RAND USR 100: is used 
instead of PRINT#4 to preceed LKdos commands for clarity.) 


WRITING to Sequential Files 
To begin, you must OPEN a file to send data to (as OUTPUT) by 


entering the command RAND USR 100: OPEN #C,”filename OUT” 
(C=channel 2-15 , the file name can be anything up to 9 chrs , 
OUT or IN is the sinclair token on the ’i’ or ’o’ keys . There 


should be 1 space between the filename and the OUT or IN token) 
After the file has been opened you can send data to it using the 
PRINT# . eg: PRINT #7; "HELLO" 

The data sent should be separated into ’records’ by using a 
comma or a return character (13) as a separator. This will allow 
the data to be read back a record at a time. 
After all data has been sent to the file, you must CLOSE the 
file . EQ: RAND USR 100: CLOSE #7 

Here is a program to demonstrate OUTputing to a file. 
10 RAND USR 100: OPEN #5,”Test.Cf OUT” 
20 FOR A=0 TO 10 
30 PRINT #5; "RECORD -";A 
40 NEXT A 
50 RAND USR 100: CLOSE #5 


(Note that only OPEN and CLOSE commands are pr eeenee by the 
LKdos RAND USR 100: , not the PRINT command. 
You can also send a program listing to a ae by using 
LIST #(ch) and if the file is open to channel 3 (printer 
3 channel) you can use LPRINT or LLIST. 


READING from a File 
-To read data back from a file, you must open it as input (IN). 
Eg: RAND USR 100: OPEN f7, "filename IN”. 
Then you can use the commands INPUT# or INKEYS# to read back the 
data in the file. eg: INPUT f7;a$; or LET a$ = INKEYS#7 
This program will read back the file and print it 
10 RAND USR 100: OPEN #5,”Test.Cf IN” 


20 INPUT #5; A$; (or LET a$=INKEYS#5) 

30 PRINT A$ 

40 PAUSE 30 ( delay to show data is read in by records) 
50 GOTO 20 


(note that INPUT or INKEYS are not. preceeded by RAND USR 100) 


INKEYS# only reads one character at a time, but INPUT# reads an 
entire record. 

If you read a file right to the end, you will get a END of FILE 
error and the file will be closed automatically. If you dont 
read to the end you must close it before any other LKdos 
Commands can be used. LKdos will send a chr€ 255 as its last 
character. If the file is read further you will get the EOF 
error. 


USES of SEQUENTIAL FILE 

Seq-files are normally used for storing data but are also very 
handy for transfering text and data between different programs. 
By opening the seq-file to channel #3 (the printer channel) you 
can ‘print’ your data to a file instead of printing it to the 
printer. You could then for example, load the file into a 
wordprocessor for modification or read the data back a bit at a 
time by a program. You can also convert Basic listings into 
ascii text by listing them to a file, or print the output from 
an assembler or dissassembler to a file. You can also read array 
basic or code files using INKEYS. 
Using a modem you could send and receive very large files 
(larger than 100K) directly to and from disk, eliminating the 
need for a large memory buffer. 


Saas Notes on sequential files ---------- 
~ when a file is open, the only LKdos command allowed is CLOSE. 
be sure to use RAND USR 100: CLOSE and not just CLOSE 


- Input works very much like a normal keyboard input. It will 
not accept some characters such as quotes ’”’ or unprintable 
characters. You can use INPUT LINE to read in quotes. INKEYS 
will read in any character though. Also there will be a 


'elick” noise for every character read using INPUT. 

- You can have more than 1 variable in an INPUT statement but 
they should only be separated by a semicolan eg: INPUT a$;b$; 

- Channel 2 is used by the 2068 to print to the main screen. If 
you open a file to channel 2 you can use ordinary PRINT 
commands without specifing a channel #. But it is tricky to 
use because no printing will be send to the screen. 

- Do not change the disk in the drive when a file is open. 

- If you ”PRINT #4:POKE 16098,3’ then this will turn off the 
deTokenizing routine in the seq-file OUTput routine. This lets 
you now send all character 0-255 to the file without the LKdos 
treating these as Timex Tokens . This means you .can use 
seq-files to store machine code files. Poke 16098,0 to return 
to normal. 

- The file name for a sequential file does not need an extension 
(eg .B or .C). This allows a lot of freedom but there are 

limitations. Such as you can not name it with a .B in the 
file name and load as basic. If the file is not to big though 
you can load it as code. 

- Only one file can be open at once, also data cannot be added 
to a file once it is closed. (These restrictions do not apply 
to the Ram based version of Seq-Files, available on disk) 


PUSH BUTTON SAVES (Nmi) 

Located on the top left corner of the disk interface is a push 
button that will save any program running in memory to disk. 

It is known as a ‘snap shot’ or Nmi save push button. The button 
triggers a Non maskable interupt in the 2-80 and Lkdos software 
in that area saves the program along with all registers and 
stack pointers. (the line on the bottom of the screen is acually 
these registers). 

When the NMI push button is triggered the computer will play a 
tune and then pause. The entire program and screen can be saved 
by press ing keys 1 to 5 which will name the file 
"NMI-S(1-5).CM” . If you do not need to save the screen and want 
to conserve disk space as well, you can press Caps Shift while 
pressing 1 to 5 and this will do a shorter NMI save that is also 
compatible with Versions 1 and 2 of LKDOS. The display file can 
be saved as "SCREEN.CM” by pressing "8". Also the "a” key will 
attempt to Stop the program by a RST 8. 

You can just press Enter to return you to your program if you 
decide to not do a save. 

To reload the saved program you need to load it as a CODE file. 

eg : Print #4: LOAD ”NMI-S4.CM” CODE 


AUTOSTART PROGRAMS 

A Basic or machine code program can be made to autorun when the 
computer is turned on if the Enter Key is held down. 

To save an auto start program, you should first reduce the size 
of disk space used by lowering ramtop with the CLEAR (address) 
command so that when you type PRINT FREE you get 150 to 200 free 
bytes. Then enter Rand USR 102:Run or Rand USR 102: GOTO 
(line#). This will cause a NMI type save .After the tune 
plays,Press "d”. This will save your Program from the start of 
the attribute file to Ramtop. 

This program will auto run when the computer is turned on with 
the Enter key pressed . The memory above ramtop will be clear, 
no UDG’s. These can be loaded if necessary as a code file 
If the Autostart program is going to load in a larger program it 
should first reset ramtop to a high value. 

-The line on the bottom of the screen is actually all the Z80 
registers ,interupt information and stack pointers. 

some Spectrum emulators need to be turned on by the command 
OUT 244,3 . To make this type of emulator be able to autorun 
a program you need to add this small machine code routine. 

The best place for this routine is in the printer buffer 
at location 23300. 


Assembly Language Decimal equivalent 
CALL 102 (decimal) 205; 102,:0 
LD A,3 62; 3 
OUT (244),A 211, 244 
RET 201 
After this program has heen loaded , you can save your autorun 


program by RAND USR 223200: RUN 
An autostart saves in 2068 mode will not run in Spectrum mode 
and viceversa. 


USER DEFINED NMI ROUTINE 

Advanced programers can load there own Nmi routine and have it 
run when they press the 'F”' key after pressing the NMI button. 
Your code should be loaded into the cartridge in an unused 
location and 8214 should be poked with the start address of the 
routine. The routine should end with a RET and should not do any 
Sinclair rom calls or disturb the registers stored at the bottom 
of the display file. This routine could be a screen copy, 
disasembler, monitor etc. Code can be loaded into the cartridge 
using standard LKdos load code commands. 


« KEMPSTON COMPATIBLE JOYSTICK 


A Kempston compatible joystick port is on the left side of the 
disk interface. It is compatible with most software written for 
the Spectrum. It is a good idea to anchor your joystick cable 
before it attaches to the board .This will prevent damage to the 
disk interface in case you accidently pull the joystick cable. 

The joy stick can be accessed by the command IN 31. Numbers 
from 0 - °! represent the joystick position. 


EXTENDED BASIC COMMANDS : 

These commands consist of extended graphic, additional Print 
and I/O device Channels and up to 3 scrolling windows on the 
screen. 


GRAPHIC COMMANDS: 

- PRINT #4: DRAW width,heigth,pattern (This is a versatile 
box fill or clear command that starts at the last plot command 
that fills in the selected pattern (0 to 9 (or 10= user defined 
pattern that consists of 8 bytes starting at address 23540) 


- PRINT #4: CIRCLE x,y,pattern (This is a region filling 
command that fills from right to left, selected blank areas of 
the screen in the patterns described above. It will fill a line 
until it finds a set pixel) x,y sets the starting pos. 


— PRINT #4: INK x (immediatly changes ink color on screen) 
- PRINT #4: PAPER x (immediatly changes paper color on screen) 


~ PRINT #4: POKE a,b This does a double poke for 16 bit 
numbers . b can be 0 to 65535 This command can be used to poke 
into the Lkdos cartridge if the address is below 16384. This can 
be used to change parameters for printer windows or files. 


Peeking into the Cartridge 

The method for peeking into the Lkdos cartridge eprom or ram is 
to first Print #4:Poke 8200, (address to be peeked). Then USR 110 
will return the peeked value . EG: this program will print the 
first 10 bytes of the LKdos Eprom. 

10 FOR A=0 TO 10 

20 PRINT #4:POKE 8200,A 

30 LET B= USR 110: PRINT A,B 

40 NEXT A 

(do not peek or poke addresses 96 to 111 or the cartridge will 
crash ) 


CHANNEL AND WINDOW COMMANDS 


- PRINT #4: OPEN #n , "device" This attaches a channel to a 
display device. (n can be channel 2 to 15 ) device can be ”wO0", 
"wl", "w2" (window 0 to 2). (See other uses for the OPEN command 


for sequential file or Large printer elsewhere in this manual.) 


- PRINT #4: CLOSE fn (n can be 2 to 15 . This is 
used for closeing channels opened with the above command. Note- 
never use the Sinclar Close command (unpreceeded by Lkdos 


switch) to close a channal opened by Lkdos) 


- PRINT #4: INPUT#(window) ,top,left pos,right pos,bottom pos 
This command defines a windows size, position and color. 
”window” is 0-2 , other parameters are standard print positions 
in absolute numbers (0 to 200r31) EG: PRINT#4: INPUT#1,0,10,20,8 
This would define window #1 to have its upper left corner at 

print pos 0,10 and the window would be 10 units wide (20-10) 

The bottom of the window would be at the 8th line. 

The screen colors that are being used when the window is defined 
will stay with that window. 


— PRINT #4: CLEAR w This will clear the window (0-2) and 
restore the print pos to the top of the window . It will also 
recolor the window. 


A 


WINDOW CHARACTER SETS 

When you turn on your 2068 the lkdos loads the 2068 character 
set into the cartridge for use with the windows. The character 
set loads into the cartridge at address 15200 and is 768 bytes 
long. You can load in 42,51,64 or proportional spaced character 
sets for use with the windows also. The first byte in each 
character in the char set determines the width of the character. 
The number of pixels set in the first byte (top pixel row) 
starting from the right sets the width of the character. No 
pixels set would indicate a full 8 pixel wide character. 

Eg: this is the character pattern for a 'Y’ character that is 
5 pixels wide. (you could print 51 of these wide on a screen) 


00000111 - This sets a character width of 5 pixels 
10001000 ~ Character data 
01010000 - Character data 
00100000 ~ Character data 
00100000 - Character data 
00100000 - Character data 
00100000 - Character data 
00000000 ~ Character data 


USING WINDOWS 

To use a window you need to Open a channel to a window and then 
define the size and position with the Print #4: INPUT command. 
After that, to use the window (or ”lp”) you can use the 
standard commands in the 2068/Spec (not preceeded by the Lkdos 
switch) such as Print #n or List#n .EG :if channel #10 has been 
opened to a window then PRINT #10; "TEST” would print to it. Or 
LIST #10 would list your program to it. 

The computer uses channel ? as the channel for standard Print 
commands to the main screen. You can open channel #2 to a window 
or printer. Then all standard Print or List will be directed 
to the selected device. 
There is a Window demo in the back of this manual. 


- When any Print #4: OPEN # command is used, 50 bytes (total) of 
memory is added to the channel table.This may cause a problem 
for a program that has machine code in a REM statement. This is 
not reclaimed by the Print #4:Close command. 


LARGE PRINTER DRIVER 

The command Print #4: OPEN # 3, "LP" will allow you to use the 
standard LPRINT and LLIST comands for your large printer. It can 
be used with Aerco Tasman or A+J printer interfaces or a user 
defined printer interface. 

You can change line length, left margin setting, and specify 
line feed and it prints Graphic characters as underlined ascii 
chrs. TAB and comma "," are supported also. 

On power up the default settings are Aerco interface, line 
length 63, line feed with carriage return and margin of 0. 

To change settings you will need to use PRINT#4:POKE Add,Seting 
These addresses are in the LKdos cartridge ram and are not 
affected by NEN. 

POKE 16090,Maximum width of print.This is set at 64 on power up. 

16092,0 if you dont want a linefeed with carriage return,10 
if LF wanted with CR. It is set at 10 on power up. 

16094,Left Margin Setting. This is set at 0 on powerup. Do 
a LPRINT after changing this. 

16096,0 for Aerco CPI, 1 for Tasman CPI ,2 for A+J CPI, 4 
for user defined interface routine.For 4, Poke 8216, 
address of the routine. 


You can open ’LP’ to any channel but channel 3 is normally for 
printer since it uses LPRINT and LLIST. You can use both Large 
printer and 2040 at the same time by opening the "LP” to a 
different channel than 3. 


COPYING and MOVING FILES 

On the disk (or tape) supplied with the system there are 
programs that are loaded in for copying disks and moving single 
files. FORMAT.Bx is used to format disks (see page on Formating) 
and to copy entire disks using 2 drives. 

Move.Bl is a program for moving 1 or more files between 2 
drives or even just 1 drive. It is very easy to use. If you 
only have one drive, enter drive 0 for both source and 
destination. 


ADDING a RAMDISK 

A 256K Ramdisk can also be controlled by LKdos as well as 4 
floppy drives. The Larken 1/4 Meg nonvolatile memory board 
attaches to the rear of the 2068 amd is available from Larken. 
It acts exactly like the other floppy drives but is very fast. 
GOTO 4 selects the ramdisk. Then all floppy commands can be 
used. Before using, you must format the Ram with the PRINT #4: 
FORMAT ”n”, command. (n= number of ramchips on the board). Users 
of the LKdos for the Aerco FD-68 can use the Aerco ram 

The Larken Ramdisk comes with complete documentation. 

Hardware experimenters can add a small ramdisk by adding 32K of 
ram in the upper 32K of the dock bank. 


USER DEFINED COMMAND , 

Advanced machine code programers can add an extra command to 
LKdos by using the PRINT #4:DATA a,b,c... command. You 
must load your new command into an unused area in the LKdos 
cartridge and the poke 8214, (address of command). 

The Larken disk Editor includes documentation on how to use MC 
with the dos and how to interpret BASIC lines. 


LKDOS ERRORS 

In addition to a number of Sinclair errors used by LKdos, a 
number of extra errors are added. 

The On-Error command in the 2068 does not recognise these extra 
errors . 


5 - Protect Error : Disk cannot be written to. It has a 
write protect sticker on it. 

T - File Not Found : The requested tile is not in the Catalog 
This can be overridden. See load command 

U - Disk Full : There is not enough room on the disk to 
save the file Or more that 100 files in 
Catalog. 

V - Wrong File Type : The file type in the extension doesn’t 


match the syntax of the command. If the 
token CODE or DATA is missing or wrong 
array type. 


W - Invalid Command : The command following the PRINT #4: is 
not used by LKdos. 

X - Cat Data Error : The Catalog cannot be read properly so 
the command is aborted. 

Y - File Open : Å sequential file is open and the only 
command allowed is CLOSE. 

Z ~ Name Exists : When renaming a file with MOVE this will 


occur if the new name is already used. 

- CRC ERROR (num) : Å cre error can will be printed on the 
screen when the dos cannot read a block 
after 10 tries. The number following the 
Cre error is the block number. 


NOTES on using the LKdos System 

- Never turn the power to the diskdrive on or off when there 
is a disk in the drive with the door closed. This can glitch a 
disk and cause loss of data. l 

- It is a good idea to keep write protect stickers on important 
disks at all times exept when you want to save or delete a file. 

~ You dont have to open the PRINT #4: command every time you 
use the Lkdos. If for example you just want to see the Cat of a 
disk, it is faster just to type Print Usr 100: CAT 7” 

But in basic programs, it is a good practice to use the PRINT#4 
command. It uses 3 less bytes that Print Usr 100: and looks 
neater . Your basic program should contain the OPEN #4,”dd” in 
it at the start of the program so that Error O - Invalid Stream 
doesn’t occur if the program is just loaded and run. 

- Never load or save code over addresses 96 to 111. This will 
cause the Lkdos cartridge to be turned off during a command and 
cause a crash. This also applies to PRINT #4: POKE and using peek 

(USR 110). 

- When you remove and install your disk interface from the 2068 
inspect the conector to make sure no pins are bent and also that 
the locating key is inplace. A damaged or ed i locating ’key’ 
can cause damage to both the 2068 and the Disk IF. 

- If you plan on distibuting some software that is on Lkdos 
disks, using disks formatted as single sided will be compatible 
on more systems than double sided disks. (48 Tpi is most common) 
- The LKdos cartridge is also available for the RAMEX, OLIGER 
and AFRCO disk systems . Your Disks are compatible with any of 
these systems. 


ADDRESSES WITHIN LKDOS THAT CAN BE POKED TO CHANGE PARAMETERS 


(using PRINT #4: POKE or peeked by USR 110) 

8195 - Dvsel ~ this is the current drive selected. 2=drv0 4=drvi 
8=drv? 16=drv3 128=drv4 (ramdisk) 

8200 - Peek - holds the address of the address to be peeked by 
usr 110 

8214 — USERad - holds the address of the user NMI function or 
the address of the User command (DATA) 

8216 — PTdrv - holds the address of the user installed printer 
interface routine. 

8718 ~ Chars - holds the address of 256- Window Character set 


=== == WINDOW POKES ----+----- 
Each window uses 20 bytes to keep its info. Window 0 
starts at 16000,W1 at 16020 and W2 at 16040. Addresses 
below are for WO. Add 20 for wl and 40 for W2. You may 
have to peek the next address and then add 256% its value 
to the value being poked when using PRINT 4: POKE. 


16004 Wscrol - Poke this with 255 to increase scroll counter 
just like in the 2068. 

16005 Xpos - Xpos of the next print pos (0-255). Dont go out 
of range of window. 

16006 Ypos - Ypos of the next print pos (0-176). Dont go out 


of range of window. 
Weol - Ink and Paper color byte for window. 
sedane PRINTER AND DETOKENIZE POKES ---~--- 
16090 - MWIDE - maximum printer width. 255 maximum 
16092 ~ LFEED - if 10 then a line feed will be send with each 
carriage return. If O then no line feed will be sent. 
16093 - PPAS - if poked to 32 then all characters Lprinted will 
be sent directly to the printer with no checking.This is 
useful for sending control chars or graphic info to the 
printer.Poke it to 0 to return to detokenizing and 
filtering. Repoke 'MARG' after poking this one because 
PRINT #4: Poke does a 2 byte poke. 
16094 — MARG - specifys left margin width . Be sure MARG + MWIDE 
does not equal more than your printer can print. (80chrs) 
16096 - PTYPE - Printer Interface type. 0=Aerco ,1=Tasman ,2=A+J 
4 = User defined. Poke USERad with address of user code 
16098 - PFLAG - poke with 3 to defeat detokenizing and filtering 
in LPRINT ”file” command and in printing to a seq-file 
Poke with 0 for restore to normal. 


FREE MEMORY in the cartridge for USER routines. Code can be 
loaded by the standard LOAD CODE LKDOS command. 

13600 - there are 1400 bytes here that are only used when the 
MERGE command is used. Å 

16100 - There are 283 bytes here free at all times. 


FORMATTING 

A floppy disk, unlike a cassette must be formatted before data 
can be saved on it. Formatting initialises all tracks and 
installs a track map , directory and disk parameters on track 0. 
Any errors will be reported as CRC errors followed by number 
indicating the track number. A good format should have no errors 
reported. 

The Format command is not on the Lkdos Cartridge but is on the 
supplied cassette. Load the cassette and put a disk in drive 0 
and close the door. The first thing to enter is the Disk Name. 
Usually the disk Name is a short name (less than 1 line) but LK- 
dos allows the Name to be up to 1000 Characters. This can be 
used for a disk description etc. The delete key (shift 0) can be 
used to correct mistakes but the editing is limited. If you 
make a big mistake you can just break the program and re RUN it. 

To end the entry of the disk name press STOP (symbol shift A). 
The drive number can be drive 1 to 4. Next is the head speed. It 
must be 6, 12 ,20 or 30 milli seconds. Most modern drives can 
run at a 6 ms head speed. Some older single sided drives such as 
the SA400 Shugart run at a slow 20 ms. (Some newer Larken disk 
interfaces may have a 1772-02 Floppy disk controller chip. The 
format program supplied with it will have a head speed selection 
of 2,3,6 and 12 ms. ) 

The number of sides should be 1 or 2. (Single sided or double) 

The next parameter to enter is the number of tracks. This 
number should be 35, 40, or 80. Most drives are 40 track. 35 
track drives are obsolete now and rarly used. An 80 track drive 
is also known as a Quad density drive 

Type "y” if the drive is ready to format the disk. The drive 
should turn on and the drive should step from track to track 
until the format is completed. 

The format program can now be saved onto the disk for future 
use . 

Break the program and type Rand USR 100: CAT ””, 

You should see a directory of the disk with all the disk info 
displayed. The term BLOCK refers to one track. The total Blocks 
on a disk is the (number of sides ) X (the number of tracks) 

The dos numbers the blocks starting irom track 0 side O . Block 
1 is track O side 1 . Block 2 is track 1 side 0 „Block 3 is 
track 1 side 1 and so on. 

The Format routine creates a track map on the directory track 
(block 0) that corresponds to the num of tracks and num of sides 
that were entered. 

When you format a single sided disk, the format routine creates 
a track map on the disk that has all side 1 tracks set as in 
use. 

Because the dos reads tracks from side to side, you cannot read 
a double sided disk with a single sided drive. Also because of 
track density, disks formated on an 80 track drive can't be read 
from 35 ar 40 track drives. 

You can however read single sided disks with a double sided 
drive. So if you have a double sided drive and you would like to 
transfer files to someone with a single sided drive, you can 
format your disk as single sided. 

All software on disk from Larken Electronics will be supplied 
on Single sided 40 track disks unless requested otherwise. 
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LKDOS OPERATION 

The Larken disk system consists of a Cartridge that contains 
the software for controlling the drive. This is called the Disk 
Operating System (DOS). On the cartridge is a 8K Eprom mapped in 
the 0-8K area of the Dos bank and a 8K Ram that is mapped in the 
8-16K area of the Dos bank. 
The Dos bank is activated when the cartridge senses a USR call 


(M1 cycle) at address 96 to 110 (decimal). For LKDOS commands 
only the address 100 is used (also 102 is used for saveing a 
autostart file). The other addesses are used by the dos as entry 


points for the Print #4 command, peek and windows. 

The dos bank is deactivated when a read of write is made to 
this area of memory. 

The command — RAND USR 100: OPEN #4,"dd”" is used to initi- 
alise the PRINT #4: Command to point to the LKdos cartridge. 
The PRINT #4: is easier to type than RAND USR 100: and there is 
no chance of accidently typeing a wrong USR address . The "dd” 
means "disk drive”. 

The Lkdos operating system manages all disk space allocation 
by using a track map. The map is created by the format program 
and resides in track 0 along with the catalog. By using the map 
the dos keeps track of used and unused areas of the disk. 

The catalog can contain up to 100 filenames. The blocks used 
by each file are kept in the Catalog also. 

Full information on Lkdos operation and accesing the dos from 
machine code is supplied with the 'Larken Disk Editor’. 


The rear mounted board is the Disk Drive Interface . This board 
controls the drive motors and the data transfer to and from the 
disk drive(s). It can control up to 4 drives. (3°23 5 = Or 


5.25” drives) The disk format used by Lkdos is double density 
with 10 sectors of 512 bytes per track (or 5120 bytes per track) 
On a 40 track Double sided drive this will give a capacity of 
over 400K per disk. On a Single sided 40 track you will have 
200K and on a 80 track double sided you will have 800K per disk. 
On each track 5090 bytes are actually uses to hold the saved 
data and the remaining 30 bytes are used by an information 
header. 

Also on the board is a push button that will trigger the NMI 
line on the Z-80. This is used to "capture" any program to disk. 
A Kempston joy stick port is also on the disk interface for 
use with most of the software that is producedfor the Spectrum. 


Memory Map of LKdos bank, 2068 Home bank and DOCK bank 
o 16K 32K 64K 


! LKDOS CARTRIDGE 1 
! 8K eprom ! 8K Ram ! 


l RAM DISK BANKS ' 
1 7» 22 27 

t n 12 97 ' 
t 99 99 929 99 t 


SETUP PROCEDURE 

Your new Larken disk system contains some chips that can be 
destroyed by static electricity. This is why to boards are 
wrapped in aluminum foil durin shipping. Observe anti- 
static precautions when handling these boards. Always make sure 
that niL power is turned OFF when installing or removing either 
of the boards. 

In addition to the Larken boards, you will need a disk drive(s) 
, a disk drive cable and a disk drive power ee ae The disk 
interface can control any priced drive except an 8” drive . 

The power supply needs to supply 5 volts and 12 volts. The cur- 
rent rating depends on the number of drives, but a general rule 
is 1 amp (on 5V and 12V) per drive. 

When using more that 1 drive, set the drive select jumpers on 
each drive, as drive 0 to 3 respectivly. Also make sure that all 
termimator resistor packs are removed from the drives EXEPT the 
drive that is connected closest to the end of the drive cable. 
Connect the cartridge and interface to the 2068 . Turn on the 
2068 type Print Usr 100. You should get the error message 

- W Invalid Command . 

Connect the drive cable to the interface and drives and power 
up the drives and 2068. The drives should not turn on. If they 
do, you may have the drive cable reversed. 

To test to see if drives are connected properly, insert a disk 

into drive 0. Type Print Usr- 100: Cat. ”", 
Drive 0 should on (LED and motor) and then after the aprox 
15 seconds it should have turned off. To test the other drives, 
Use the command Print Usr 100: GOTO drive number (0-3) then use 
the Print Usr 100: Cat ””, to activate the drive. 


If you did not purchase the disk drive cable you can make your 
own useing 2 feet of 34 conductor ribbon cable and 2 or more 
34 position ribbon cable edge card connectors. The best way to 
install the connectors on to the cable is to use a Vise to 
squeeze the connector. The connector on the interface end should 
be mounted opposite to the drive connector(s). If you use more 
than 1 drive, space the drive connectors 3” apart. 

Installing the cable on backwards will not cause any damage, 
but the drives will turn on. 


(nter face to Dru Gable 


ne EN) 


IF Drives 


RETURNING DAMAGED ITEMS FOR REPAIR 

If your Larken product is damaged, you can return it to Larken 
for repair. Only return Larken items and do not send diskdrive 
or powersuppy unless requested so by Larken. Sending electronic 
items from the US to Canada is sometimes a problem so if you 
must put a value on the package keep the value low (preferably 
less that $40 or the customs may charge me duty as i have no 
proof that i am not buying the item. Ive had a lot of trouble 
with this in the past. Also avoid sending by a courier. Send by 
regular mail. 
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EXTENDED BASIC DEMO PROGRAMS 


REM ##%% WINDOW DEMO #### 
PRINT USR 100: OPEN &4,"dd” 


S CLS : INK 7: PAPER av 


PRINT #4: OPEN #5 
PRINT 44: INPUT 76. 3, 15,10 


INK O: PAP 

PRINT #4: OPEN #6 e 

PRINT 44: dd AM rd 10,30,20 

INK 0: PAPER CL$ 

PRINT #4; CLEAR 6 0: PRINT #4: CLEAR 1 

PRINT #0; "Press Enter for ‘SCROLL 2?’ 

LIST #S: LIST #6: LIST #5: LIST #6: LIST #5 


REM sn DRAW DEMO xxs» 

RANDOMIZE USR 100: OPEN ø4, "dd" 

LET x=INT (RND#200): LET ys INT (RND#150) 

PLOT x,y: PRINT #4: DRAW 40,40,1 

0 PT ad PRINT #4: DRAW. 36, 36,INT (RND#8) +1 


REM pruna lve Den 36 38 3 38 3 


REM w Ho 
RANDOMIZE USR "1007 "GREN #4, "dd" 
O PLOT 30,20: DRAW 7 O: DRAW 60,60: DRAW 0,50: DRAW -35 
D 60: "39: -35: DRAW 60,60: DRAW -60,-60: BRAG 0,-50 


O DRAW -70,0: DRAW. 6, 50: DRAW 35,35: DRAW -35,-35: DRAW 70,0 


REM ------ Fill House ------ 
PRINT #4: CIRCLE 50,50,8 
PRINT #4: CIRCLE 106,160, 2 


O PRINT #4: CIRCLE 130, 60 


REM -- UDP for Pattern {9 -- 
RE 


2 RESTO 


FOR a=23540 TO 23548 
READ b: POKE a,b 
NEXT 


a 
DATA 15,240,15,240 ata. 15,240,15,240 
PRINT #4: „CIRCLE 30. 3671 


PLOT 60,20: PRINT #4: DRAW 10 20,1 
PLOT 61,20: PRINT 44: DRAW 8,19,0 


FROM: 
LARKEN ELECTRONICS 
RR#2 NAVAN ONTARIO 
CANADA K4B-1H9 
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ADDING a LROS Cartridge chip to the LKDOS Cartridge ( Not Aero FD-68) 
Don't attempt this unless you have a proper soldering iron 
and experience. in delicate soldering. Larken Electronics will 
do this mod for #5. 
Parts needed - 28 pin IC socket , 74HCT32 IC 
Use a low power soldering pensil that is properly grounded. 
~ temperarily remove the eprom from the LEDOS cartridge. Bend 
pins 20 and 22 on the socket outward. Note ~ all IC's have there 
pin 1 (dot or notch) towards the center of the cartridge. 
Install the 28pin socket on top of the BE ram IC (the 28 pin IC 
that is solded to the board). Carefully solder all pins exept 
20 and 22. (you only need a tiny bit of solder). Carefully 
remove all leads from the 74HCTS2 exept pins 1,2,2,7,14. Bend 
pins 1 and 3 up (fold the lower half back up). Stack this chip 
on top of the middle 14 pin IC. (pin 1 faces in) and solder the 
pins 2,7 and 14 to the same pins on the IC beneath. 
Run a small wire from pin 3 on the HCTS2 to pins 20 and 22 on 
the 28 pin socket. Run a small wire from pin 1 on the HCTZ2 to 
the ROS enable connection near the buss. thats it ! 
Check for any shorts or solder bridges . Reinstall the LEDOS 
eprom and test it in the 2068 to see if it still works ok. 
Remove the eprom for your 05-64 or Spectrum emulator and insert 
it into the socket. If it doesnt work, recheck your work 
If you have a Spectrum ROM chip (not Eprom), part num:23128 
it may not work unless you bend pin 27 out 
to the socket) and ground this pin (connect 
pin 14 to pin 27). 


På de = — Pin 14 Not Bent 


The Spectrum rom can be turned 
on by the command OUT 244,3 or 
by pressing ‘K’ on powerup. 


(so it doesnt go in 
a small wire from 
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The Spectrum 23128 Rom ` 


The 23128 Rom (NEC and others) has 3 chip selects whic 


h 
cause problems (it cant be deselected by Tkaosi when installed 
in the 2068 rom socket or in the optional eprom socket on the 
Lkdos board. 


-If you want to remove th 
rom, er must bend out p 
sold 


e 2068 rom and install the Spectrum 
and er a small wire 


in 22 so it wont go into the socket. 
rom it to pin 27. 


-If you want to install the Spectrum rom into a socket added 
to the Lkdos cartridge you must bend out pin 27 so it doesnt 
go into the socket and solder a small wire from it to pin 14 


Modified For 2068 Rom Modified For Lkdos socket 
Socket 


(This is eprom compatible) 


ee ee ee e 


l ag 
27 


S Bend out 


27 tolt 


IF 
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CIRCUIT for NMI SAVE Push button ~—— (Aere Ramex ov Clger Enly) 
For the NMI save to work properly a push button circuit with no 
bounce and a short pulse is critical. This circuit is only a 
simple idea but you should use a flip flop or a latch like this. 
A capacitor, schmitt trigger type debounce circuit should'nt be > 
used because it doesnt produce a single pulse. 
To test the nmi button you can trigger it within a program and 
the press enter. The tune should only play once (start and end) 
and the program should continue. If the tune repeats its self 
or the program crashes then the switch has bounced. 


[C= 74LS 13A ¥ 470 —/500 PF 


Type 


